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Preface 

Purpose and Scope 

The purpose of this manual is to help you troubleshoot errors returned in 
your HP FTAM/9000 applications. This manual lists the errors, probable 
causes, and corrective actions. Additionally, this manual includes the HP 
FTAM/ 9000 reference pages. 

This manual lists FTAM error and reference information. If you are 
learning FTAM and need more comprehensive explanations, refer to the 
HP FTAM/9000 Programmer's Guide. 

FTAM/9000 runs on H P OTS/9000, an H P network product that provides 
a lower-level OSI protocol "stack," in conjunction with an 802.3 network 
link. 

Audience 

This manual is for application programmers who are familiar with theC 
programmi ng I anguage and who need to correct errors i n thei r 
applications. This manual is also for programmers who need to consult 
the FTAM/9000 reference pages (which are copies of the online man 
pages). 

MAP 3.0 Interface Note 

Users should note that the FTAM/9000 programmatic interface is taken 
from the MAP 3.0 specification for FTAM. The MAP 3.0 FTAM 
specification includes error codes and other details, which consequently 
appear in the programmatic interface to FTAM/9000. This document 
contains numerous references to MAP-based details found in 
FTAM/9000. 


Organization 


Chapter 1 

Chapter 2 

Chapter 3 

Chapter 4 

Chapter 5 

Chapter 6 
Chapter 7 


FTAM return_codesThis chapter contains a list of 
FTAM errors returned in the 
inout_dcb->resuIt_code.return_codefield. Possible 
causes and recovery actions are also listed. 

HP vendor_codesThis chapter contains a list 
H P-specific errors returned i n the 
inout_dcb->result_code.vendor_codefield. Possible 
causes and recovery actions are also listed. 

Diagnostic error_idsThis chapter contains a list of 
diagnostic values returned in the 
inout_dcb->diagnostic->error_id field. Possible 
causes and recovery actions are also listed. 

Event Management ErrorsThis chapter contains a 
list of values returned when calling em_wait(), 
em_fdmemory(), and em_gperror(). These errors 
return in the result->return_code and 
result->vendor_codefields. Possible causes and 
recovery actions are also listed. 

HP FTAM/9000 PICSThis chapter contains 
information on how to obtain a copy of the Protocol 
I mplementation Conformance Statement (PI CS) for 
the HP FTAM/9000 product. Use this information in 
conjunction with other vendor's PICS to determine 
how the various responders communicate. 

Installation FilesetsThischapter liststhefilesets 
created during FTAM/9000 installation. 

HP FTAM/9000 Reference PagesThis chapter lists 
the H P FTAM/9000 reference pages (man pages) that 
are avail able online. 
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Documentation Guide 


For More 
Information 

I installing and 
Configuring H P 
FTAM/9000 

Troubleshooting H P 
FTAM/9000 

FTAM Programming 

FTAM Protocol 
Specifications 

I nternational 
Standards ISO 8571 

MAP 3.0 I nterface 
Specifications 

NBS Phase 111 


ACSE 


Read 


I nstalling and Administering HP 
FTAM/ 9000 (B1033-90034) 


OSI Troubleshooting Guide(32070-90020) 


H P FTAM/ 9000 Programmer's Guide 
(B1033- 90014) 

ISO 8571, Information Processing Systems- 
Open Systems I nterconnection - File 
Transfer, Access and M anagement 

ISO 8571, Information Processing Systems- 
Open Systems I nterconnection - File 
Transfer, Access and M anagement 

MAP 3.0 Application I nterface Specification 


I implementation Agreements for Open 
Systems I nterconnection Protocols from the 
NBS Workshop for I mplementors of Open 
Systems I nterconnection 

ISO 8649, Information Processing Systems- 
Open Systems I nterconnection - Service 
Ddnnition fortheAssociation Control Service 
Element 
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FTAM return codes 


This chapter lists the inout_dcb->result.return_codes. The initiator and 
responder detect FTAM errors and return them in the user program as 
integer defined constants. 
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FTAM return codes 


• The mapftam.h file contains defined constants for FTAM 
return_codes. 

• To obtain a printable character string for the error, call ft_gperror(). 

Refer to the "H andl i ng E rrors" chapter i n the H P FTAM / 9000 
Programmer's Guide for information on checking for and handling 
errors. 
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inout_ 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


dcb->resuIt.return code 


FTE000_SUCCESS 

Successful function execution (noerror). 

I nformative message; no action required. 


FTEOO1_INV_EVENT_NAME 

The return_event_name is a negative value and 
therefore, invalid. 

Call the function with a valid, positive 
return &/ent name 


FTE002_DUP_EVENT_NAME 

You previously made an asynchronous call using the 
same value for return_event_name. 

Call the function asynchronously with a 
return_a/ent_namethat is not already in use. 


FTEOO 3_ABORT_IND_RCVD 

An abort indication was received on theconnectionjd 
specified in the call. 

Call ft_ireceive() to obtain abort information. Perform 
error recovery based on the information returned in 
either the i nout_dcb->i nfo.pabort_i nfo or 
inout_dcb->info.aabort_infofield. If the error still 
occurs, refer to the OSI Troubleshooting Guide. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTEOO4_BUFFER_OVERFLOW 

CAUSE 

The inout_dcb specified is not large enough to hold the 
output of the call. 

ACTION 

You have two options: 

• Call the function with the address of a NULL 
i nout_dcb, thus requesti ng the i nterface to 
dynamically allocate the output area. 

• Call the function with a larger buffer. 

MESSAGE 

FTE005_INV_CONN_ID 

CAUSE 

The connectionjd from ft_connect() is no longer active 
or ft_connect() did not return the connectionjd. 

ACTION 

Call the function with a valid, active connectionjd 
returned from an ft_connect() request. 

MESSAGE 

FTEOO 6_NETWORK_UNAVAIL 

CAUSE 

All contact with ftamjnit was lost either because it 
was killed or exited. 

ACTION 

Call ft_aeactivation() to activate another ftamjnit. If 
the error still occurs, ter min ate the application and 
refer to the OSI Troubleshooting Guide. 

MESSAGE 

FTE007_NO_REQ_RESOURCES 

CAUSE 

Current resources are i nsufficient to honor the request; 
virtual memory is exhausted. 

ACTION 

Check your memory management. F ree any unused 
resources (e.g., memory), call ft_dfdcb() to free DCBs 
that are no longer needed, and call the function again. 
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CAUSE 

ACTION 
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CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTEO 0 8_NO_CON_RESOURCES 

Noconnection resources are available; generated on 
ft_sdata() when connection resources are temporarily 
exhausted. 

Call ft_nwcleared(); when this request is noted (the 
resources are freed), call ft_sdata() again. 


FTEOO 9_RELEASE_REQ_ISSUED 

You called a function on a connection that had an 
un-noted release request. 

Call ft_connect() to establish a new connection and 
continue processing. When calling functions, always 
use an active connectionjd returned from ft_connect(). 


F T E 010_MY_DIR_NAME_UNKNOWN 

The my_dir_nameassociated with ftamjnit is 
unknown. Either it does not exist, or you incorrectly 
typed the name. 

Call ft_aeactivation() with a configured my_dir_name. 


FTE01l_AE_INVOC_EXHAUSTED 

You reached the maximum number of allowable AE 
invocations between the user program and ftamjnit. 

You have three options. 

• Write programs to use fewer AE invocations. 

• Finish processing on AEs and deactivate them. 

• Reconfigure the system to support more AE 
invocations. 


Chapter 1 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

F TE 013_BAD_AE_LABEL 

CAUSE 

The aejabel was deactivated or not returned from an 
ft_aeactivation() request. 

ACTION 

Call the function with a valid, active aejabel returned 
from an ft_aeactivation() request. 

MESSAGE 

FTE015_FUNCTIONING_CONNECT 

CAUSE 

You called ft_aedeactivation() when ftamjnit had one 
or more open connections. 

ACTION 

You have two options. Finish processing on the 
connection, 

• Call ft_rrequest() to release the connection, and call 
ft_aedeactivation() to deactivate ftamj nit. 

• Call ft_aereset() to abruptly abort all open 
connections and then call ft_aedeactivation() to 
deactivate ftamj nit 

MESSAGE 

FTE016_LACK_TARGET_INFO 

CAUSE 

1 nsufficient target address information; either the 
called_dir_name or 

input_dcb->called_presentation_address parameter is 
missing from ft_connect(). You must provide one or 
both. EXAMPLE: You called ft_connect() with a NULL 
cal 1 ed_di r_name and 0 i n the i nput_dcb- 
>called_presentation_address.n_nsaps parameter. 

ACTION 

Call ft_connect() with a valid called_dir_name or 
input_dcb->called_presentation_address parameter. If 
you provide both, 

input_dcb->called_presentation_address has 
precedence. 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE017_CONTEXT_NAME_MIS SING 

Thecontext_name is missing. EXAMPLE: You called 
ft_connect() with a 0 (zero) in the 
input_dcb->context_namelength field. 

Call the function with the following FTAM 
context name 1 0 8571 1 1. 


FTE018_CALLED_DIR_NAME_NO_ADDR 

On ft_connect(), thecalled_dir_namefor the FTAM 
responder has no associated presentation address. 
Either called_dir_nameis not configured on your 
network, or you incorrectly typed the name. 

Call ft_connect() with a configured called_dir_name 
that identifies the FTAM responder to which you are 
trying to connect. 


FTE019_CONNECT_EXHAUSTED 

You reached the maximum number of allowable 

connections between ftamjnit and the responder. 

You have three options. 

• Activate another ftamjnit and call ft_connect() 
again. 

• Finish processing on some of the open connections 
and re-use those connections. 

• Finish processing on some of the open connections, 
cal I ft_rrequest() or ft_abort() to rel ease or abort the 
connection, and call ft_connect() again. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE02l_USER_ABORTED_CONN 

CAUSE 

You attempted processing on a connection on which 
ft_abort() was requested, but not noted. 

ACTION 

Open another connection and call the function again. 
Attempt processing only on active connections. 

MESSAGE 

FTE024_USER_RELEASED_CONN 

CAUSE 

You attempted processing on a connection on which an 
ft_rrequest() was successfully completed. 

ACTION 

Call ft_connect() to establish a connection and perform 
the appropriate processing. Attempt processing only on 
active connections. 

MESSAGE 

FTE025_PROTOCOL_ERROR 

CAUSE 

A function call violated an FTAM protocol in one of the 
following ways. 

• You called a function outside the current regime. 

• You called an illegal function within a group. 
EXAMPLE: You called ft_rdata() after receiving a 
data end indication. 

ACTION 

E nsure you are i n the correct regi me for cal 1 i ng the 
function. Call only functions that are allowed within 
the group. 

MESSAGE 

FTE026_INVALID_INPUT_DCB 

CAUSE 

Invalid input_dcb; you passed a NULL pointer to a 
function with mandatory parameters in the input_dcb. 

ACTION 

You have two options. Set all mandatory input_dcb 
parameters and call the function again. Call ft_didcb() 
to automatically initializethe input_dcb. 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE02 7_INVALID_INOUT_DCB 

You set the i nout_dcb parameter address to N U L L and 

passed this parameter to an FTAM function call. 

You have two options. 

• Pass a valid, non-NULL pointer to the inout_dcb 
poi nter. 

• Call ft_didcb() to set the inout_dcb, passing an 
additional_size large enough to hold all possible 
i nout_dcb data. Pass the address of the poi nter 
returned by ft_didcb() to the FTAM function. 


FTE02 8_NO_MIN_OUT_SPACE 

You did not provide the minimum, required inout_dcb 
space. The i nout_dcb->size must be large enough to 
return the size and result structure (12 bytes). 

You have two options. 

• Call the function with the address of a NULL 
inout_dcb buffer, indicating the interface should 
dynamically initialize the DCB. 

• Call the function with a larger inout_dcb buffer (at 
least 12 bytes). 


FTE029_AABORT_IND_RCVD 

A user abort indication arrived before the responder 
confirmed ft_connect(). 

Refer to the OSI Troubleshooting Guide 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE030_APABORT_IND_RCVD 

CAUSE 

A provider abort indication arrived before the 
responder confirmed ft_connect(). 

ACTION 

Refer to the troubleshooting manual for your protocol 
stack. 

MESSAGE 

FTE031_INVALID_BUF_PTR 

CAUSE 

Invalid buffer pointer; you provided a NULL pointer 
instead of a valid address. EXAMPLE: You called 
ft_connect() and passed a NULL output connectionjd 
poi nter. 

ACTION 

Call the function with a valid, non-NULL pointer. 

MESSAGE 

FTE032_IPC_ERROR 

CAUSE 

General 1 PC error; communication between the user 
program and ftamjnit is lost. 

ACTION 

Refer to the troubleshooting OSI Troubleshooting 

Guide. 

MESSAGE 

FTE034_PROVIDER_INIT_ERROR 

CAUSE 

Cannot initialize ftamjnit. 

ACTION 

Refer to the OSI Troubleshooting Guide 
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CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE035_CONFIRMATION_FAILED 

The FTAM responder detected an error and sent a 
negative confirmation toftamjnit. 

Examine the following inout_dcb fields for additional 
error information, and take action accordingly. 

• result.vendor_code 

• di agnosti c->error_id • di agnosti c->further_detai I s 

• action_result 

• state result 


FTE03 6_INV_PRES_ADDRESS 

The maximum number of selectors or nsaps was 
exceeded. EXAMPLE: You called ft_connect() and set 
the input_dcb- >called_presentation_ address.n_nsaps 
field to a value greater than 8. 

Call ft_connect() with valid fields within the 
presentation address (struct P_address). Max. 
psap_selector length =16 octets Max. ssap_selector 
length =16 octets Max. tsap_selector length =32 octets 
Max. nsap length =20 octets Max. number of 
n_nsaps=8 


FTE037_SYSTEM_STATE_ERROR 

Internal inconsistencies occurred. 

Refer totheOSI Troubleshooting Guide 


FTE038_DIRECTORY_ERROR 

Unableto access directory information. 
Refer totheOSI Troubleshooting Guide 
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FTAM return_codes 

inoul_dcb->result.return_code 

MESSAGE FTE04 0_INV_MY_DIRNAME 

CAUSE The my_dir_namestructure syntax is incorrect on 

ft_aeactivation(). EXAMPLE: You specified 
my_dir_namewith a negative number of rdns. 

ACTION Call ft_aeactivation() with a syntactically correct 

my_dir_name The n field in struct Dir_dn or struct 
Dir_rdn must be a positive value. If you provide an 
attrjd and attr_valuein struct Dir_ava, each field 
must have a length greater than zero and the pointer 
set to a non-N U LL val ue. I f you do not provide these 
fields, the length must be zero. 


MESSAGE FTE041_INV_MY_AE_T I TLE_OP T 

CAUSE I nvalid my_ae_title_option parameter for 

ft_aeactivation(); the specified value is not within the 
Ae_title_option enumeration. 

ACTION Call ft_aeactivation() with a syntactically correct 

my_ae_titl e_opti on. 
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ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE042_INV_MY_AE_TITLE 

I nvalid my_ae_titie parameter on ft_aeactivation(); 
syntax is incorrect. EXAMPLE: You called 
ft_aeactivation() and specified User_object_id_ option 
as the my_ae_title_option. You then passed in an 
invalid struct Objectjd as the ae_object_id. 

Call ft_aeactivation() with a syntactically correct 
my_ae_title 

• I f the ae_ti tl e i s a directory distinguished name(i.e., 
you supplied ae_dir_dn), then field in struct Dir_dn 
or struct Dir_rdn must be a positive value. If you 
provide an attrjd and attr_valuein struct Dir_ava, 
each field must have a length greater than zero and 
the poi nter set to a non-N U L L val ue. 

• If the ae_titleis an object ID (i.e., you supplied 
ae_object_id), the length must be greater than zero 
and the poi nter must be a non-N U L L val ue. 


FTE043_INV_CALLED_DIR_NAME 

I nvalid called_dir_name parameter on ft_connect(); 
syntax is incorrect. EXAMPLE: You specified 
called_dir_namewith a negative number of avas. 

Call ft_connect() with a syntactically correct 
called_dir_name The n field in struct Dir_dn or struct 
Dir_rdn must be a positive value. If you provide an 
attrjd and attr_valuein struct Dir_ava, each field 
must have a length greater than zero and the pointer 
set to a non-N U LL val ue. I f you do not provide these 
fields, the length must be zero. 
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FTAM return_codes 


inout_dcb->result.return_code 

MESSAGE 

FTE044_INV_CALLED_AE_T_OPT 

CAUSE 

Invalid called_ae_title_option parameter; syntax is 
incorrect; the specified value is not within the 
Ae_title_option enumeration. 

ACTION 

Call ft_connect() with a syntactically correct 
ca 11 ed_ae_ti tl e_opti on. 

MESSAGE 

FTE045_INV_CALLED_AE_TITLE 

CAUSE 

Invalid called_ae_titleparameter; syntax is incorrect. 
EXAMPLE: You called ft_connect() and specified 

U ser_object_id_option as the cal 1 ed_ae_title_option. 

You then passed an invalid struct Objectjd as the 
ae_object_id. 

ACTION 

Call ft_connect() with a syntactically correct 
my_ae_title 


• If the ae_title is a directory distinguished name(i.e., 
you supplied ae_dir_dn), then field in struct Dir_dn 
or struct Dir_rdn must be a positive value. If you 
provide an attrjd and attr_valuein struct Dir_ava, 
each field must have a length greater than zero and 
the poi nter set to a non-N U L L val ue. 

• If the ae_titleis an object ID (i.e., you supplied 
ae_object_id), the length must be greater than zero 
and the poi nter must be a non-N U L L val ue. 

MESSAGE 

FTEO 90_INV_DYNAMIC_MEM_PTR 

CAUSE 

You passed a poi nter to ft_fdmemory() that was not 
allocated by ft_gperror(). 

ACTION 

Only pass pointers allocated by ft_gperror() to 
ft_fdmemory(). 
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CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTEO 92_INV_ADDITIONAL_SIZE 

The cause may be one of the foil owing. 

• You requested an additional_sizefor an input_dcb. 

• You requested an additional_sizefor an inout_dcb 
that caused an allocation failure. 

• Call ft_didcb() with an additional_sizefor an 
inout_dcb only. 

• Call ft_didcb() with a smaller additional_sizefor 
theinout deb. 


FTEO 94_INVALID_DCB_POINTER 

You passed a pointer toft_dfdcb() that was not 
allocated by ft_didcb(). EXAMPLE: You called mallocO 
to allocate memory for an Ft_fcopy_out_dcb and then 
called ft_dfdcb() to free the pointer. 

If you cal I edft_didcb() to allocate the pointer, call 
ft_dfdcb() to free it. If you called mallocO to allocate 
the poi nter, cal I free() to free it. 


FTEO 95_NWC_REVOKED 

Theft_nwcleared() request was revoked; you called a 
function (on a specified connectionjd) that had an 
un-noted ft_nwcleared() request. You will not know 
when the resource is free. 

I nformative message; no action required. 


FTEO 96_INVALID_DCB_TYPE 

The dcb_type requested in the call toft_didcb() is 
nonexistent. 

Call ft_didcb() with a known dcb_type 


Chapter 1 


27 




FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTEO 97_NO_SPACE_AVAILABLE 

CAUSE 

N o memory avai 1 abl e. 

ACTION 

Check your memory management. Free any unused 
resources (e.g., memory), call ft_dfdcb() to free DCBs 
that are no longer needed, and call the function again. 

MESSAGE 

FTEO 98_INVALID_RETURN_CODE 

CAUSE 

The result->return_code passed toft_gperror() is 
invalid or non- existent; it has no associated error 
string. 

ACTION 

Call ft_gperror() with a valid, defined return_code 

MESSAGE 

FTEO 9 9_NO_RESOURCE_OUTSTANDING 

CAUSE 

No resource outstanding; you called ft_nwcleared() 
without previously receiving the 
FTE008_NO_CON_RESOU RCES error. The 
ft nwclearedO function is valid only if an 
FTE008_NO_CON_RESOU RCES error returns on an 
ft_sdata() function. 

ACTION 

Call ft nwclearedO only when you receive a 
FTE008_NO_CON_RESOURCES error. 

MESSAGE 

FTEl0l_BUFF_TOO_BIG 

CAUSE 

Buffer holding user data to send (ft_sdata()) is too 
large for implementation (more than 7K or 14 
data_units). 

ACTION 

Call multi pie ft_sdata() functions with smaller or 
fewer buffers, or as smaller number of data_units. 
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ACTION 

MESSAGE 
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ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE102_BUFF_TOO_SMALL 

The inout_dcb on an ft_rdata() request is not large 
enough to hold the output of the call or the 
des_requested parameter is greater than 12. 

Exit the Data Transfer regime to the File Open regime. 
Call ft_read() and ft_rdata(). Ensure all inout_dcbs are 
large enough to hold all possible data or let the 
interface allocate the inout deb. 


FTEl04_CONFIRM_NOT_RCVD 

The responder did not confirm this grouped request; an 
error on a previous request in the group was detected, 
and theend group confirm was immediately generated. 
EXAM PLE: You called the following sequence of 
functions: ft_bgroup(), ft_select(), ft_open(), and 
ft_egroup(). After these passed across the network, the 
responder detected an error on ft_select(). Theft_open() 
was not processed, and theft_egroup() confirm was 
sent. This error would return on ft_open(). 

The error probably occurred on a previously confirmed 
request within the group. Examine the foil owing 
inout_dcb fields for previously confirmed requests and 
take action 

accordingly.result.vendor_codedi agnostic->error_iddi a 
gnosti c->f u rther_deta i I sacti on_resu I tstate_resu I tE X A M 
PLE: Examine the inout_dcbfor ft_select() to 
determi ne the cause of the error. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE105_CONT_TYPE_UNSUPPORT 

CAUSE 

The specified contents type is not supported (i.e., is not 
an FTAM-1, FTAM-2, FTAM-3, or NBS-9document 
type). EXAMPLE: You called ft_open() with a 
contents typecontents form of 
FT_ABS_SYN_CON_SET_PAI R_FORM. 

ACTION 

Call the function with a supported contents_type. For 
all functions requiring a contents_type, ensure 
contents typecontents form = 

FT_DOCUMENT_TYPE and 

contents typecontents info, document.nameindicates 
FTAM-1, FTAM-2, FTAM-3, or NBS-9. For ft_fopen() 
and ft open(), contents typecontents form can be 
FT_CONTENTS_UN KNOWN. 

MESSAGE 

FTEl12_GROUP_NOT_OPEN 

CAUSE 

Grouping was not open on the connection. You called 
ft_egroup() before cal 1 i ng ft_bgroup(). 

ACTION 

Call ft_bgroup() on a connection before calling 
ft_egroup(). 

MESSAGE 

FTEl13_GROUP_ALREADY_OPEN 

CAUSE 

Grouping was already open on the connection. You 
called ft_bgroup() on a connection on which you 
already called ft_bgroup(). 

ACTION 

Close the group by calling ft_egroup(). Open another 
group with an ft_bgroup() request. 
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FTAM return_codes 

inout_dcb->result.return_code 


FTEl14_INV_ACCESS_CNTL 

Invalid bits areset in the actionjist field of struct 
Ft_access_control_element. EXAMPLE: You set Bit (1) 
in the parameter, but only Bits (8) to (15) are valid for 
the actionjist. 

Correctly set the FT_FA_XXX bits and call thefunction 
again. 


FTEl15_INV_ACSCTL_ID 

I nvalid identity field of struct 
Ft_access_control_element; syntax is incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTEl16_INV_ACSCTL_PASSWDS 

Invalid password in access_passwords field of struct 
Ft_access_control_element; syntax is incorrect. 

Call thefunction with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the poi nter is NULL or if thelength isgreater 
than 65535. 


FTEl18_INV_ACCOUNT 

I nvalid account parameter; syntax is incorrect. 

E nsure characters i n the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 
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FTAM return_codes 

inout_dcb->result.return_code 


MESSAGE FTE11 9_INV_ACCS_C0NTEXT 

CAUSE I nvalid access_context parameter for ft_read(); the 

specified value is not within the Ft_access_context 
enumeration. 

ACTION Call ft_read() with a valid access_context. 


MESSAGE FTE12 0_INV_ACTION_RESULT 

CAUSE I nvalid action_result parameter for ft_abort(), 

ft_edata(), ft_cancel(), or ft_rcancel(); the specified 
value is not within the Ft_action_result enumeration. 

ACTION Call the function with a valid action result. 


MESSAGE FTE121_INV_DIRNAME 

CAUSE I nvalid dirname parameter for ft_frattributes(), 

ft_fcattributes(), or ft_fdelete(); syntax is incorrect. 
EXAMPLE: You specified dirname with a negative 
number of avas. 

ACTI ON Call the function with a syntactically correct dir_name. 

The n field in struct Dir_dn or struct Dir_rdn must be 
a positive value. If you provide an attrjd and 
attr_valuein struct Dir_ava, each field must have a 
length greater than zero and the pointer set to a non- 
NULL value. If you do not provide these fields, the 
length must be zero. 
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FTAM return_codes 

inout_dcb->result.return_code 


FTE122_INV_ATTR_FILENAME 

I nvalid filename parameter for ft_cattri butes() or 
ft_fcattributes(); syntax is incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTE125_INV_CONCUR_CNTL 

One of the Ft_concurrency_control fields contains an 
invalid file lock. The file lock is not in the Ft_file_lock 
enumeration. 

Call the function with a valid file lock in each 
concurrency_control field. 


FTE127_INV_CREATE_ID 

I nvalid identity_of_creator parameter; syntax is 
incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTE12 8_INV_DELETE_ACT 

I nvalid delete_action parameter for ft_fclose(); the 
specified value is not within the Ft_delete_action 
enumeration. 

Call ft_fclose() with a valid delete_action. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE12 9_INV_DEST_ACCOUNT 

CAUSE 

1 nvalid input_dcb->dest_account parameter for 
ft_fmove() or ft_fcopy(); syntax is incorrect. 

ACTION 

Ensure characters in the parameter are part of the 
graphic stri ng character set. These ordinal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 

MESSAGE 

F T E13 0_I NV_D E S T_D IRNAME 

CAUSE 

1 nvalid destination_dirnameparameter on ft_fmove() 
or ft_fcopy(); syntax is incorrect. EXAM PLE: You called 
ft_fmove() and specified destination_dirnamewith a 
negative number of rdns. 

ACTION 

Call the function with a syntactically correct 
destination_dirname. The n field in struct Dir_dn or 
struct Dir_rdn must bea positive value. If you provide 
an attrjd and attr_valuein struct Dir_ava, each field 
must have a length greater than zero and the pointer 
set to a non-N U LL val ue. 1 f you do not provide these 
fields, the length must be zero. 

MESSAGE 

FTE131_INV_DEST_FNAME 

CAUSE 

Invalid destination_filenameparameter; syntax is 
incorrect. 

ACTION 

Ensure characters in the parameter are part of the 
graphic string character set. These ordi nal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 
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FTAM return_codes 

inout_dcb->result.return_code 


FTE132_INV_DEST_INIT_ID 

I nvalid input_dcb->dest_init_id parameter for 
ft_fmove() or ft_fcopy(); syntax is incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTE133_INV_DIAG_STRUCT 

Invalid struct Ft_di agnostic structure; syntax is 
incorrect. 

Call the function with syntactically correct fields 
within struct Ft_diagnostic. Ensureyou set all 
required fields. 

• The error_source and error_observer must be i n the 
Ft_entity_ref enumeration. 

• The diag_type must be in the Ft_diag_type 
enumeration. 

• The further_detai Is characters must be part of the 
graphic string character set. These ordinal values 
are 32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTE135_INV_FILENAME 

I nvalid filename parameter; syntax is incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE13 6_INV_FILE_STATUS 

CAUSE 

1 nvalid file_status parameter for ft_create() or 
ft_fopen(); the specified value is not within the 
Ft_file_status enumeration. 

ACTION 

Call the function with a valid file_status. 

MESSAGE 

FTE137_INV_INITIATOR_ID 

CAUSE 

Invalid initjd or initiator_identity parameter; syntax 
is incorrect. 

ACTION 

E nsure characters i n the parameter are part of the 
graphic string character set. These ordinal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 

MESSAGE 

FTE138_INV_LEGAL_QUAL 

CAUSE 

Invalid legal_qualification parameter; syntax is 
incorrect. 

ACTION 

E nsure characters i n the parameter are part of the 
graphic string character set. These ordinal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 

MESSAGE 

FTEl4 2_INV_PERM_ACTS 

CAUSE 

The bits for the FT_PA_XXX defined constants are not 
set correctly in the permitted_actions parameter. 
EXAMPLE: You set Bit (1) in the parameter, but only 
Bits (5) to (15) are valid. 

ACTION 

Correctly set the FT_PA_XXX bits and call thefunction 
again. 
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FTAM return_codes 

inout_dcb->result.return_code 


FTEl43_INV_PROC_MODE 

I nvalid bits are set in the processi ng_mode parameter. 
EXAMPLE: You set Bit (1) in the parameter, but only 
Bits (11) to (15) are valid. 

Call ft_open() with valid bits set in the 
processi ng_mode parameter. 


FTEl4 8_INV_REQ_ACCESS 

I nvalid bits are set in the requested_access parameter 
for ft_create(), ft_fopen(), or ft_sel ect(). EXAM PLE: You 
set Bit (1) in the parameter, but only Bits (8) to (15) are 
val id for the requested_access. 

Correctly set the FT_FA_XXX bits for the 
requested_access parameter and call the function 
again. 


FTEl4 9_INV_SRC_ACCOUNT 

I nvalid input_dcb->source_account parameter 
forft_fcopy() or ft_fmove(). 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 
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inout_dcb->result.return_code 

MESSAGE 

F T E15 0_INV_SRC_DIRNAME 

CAUSE 

1 nvalid source_dirname parameter for ft_fcopy() or 
ft_fmove(); syntax is incorrect. EXAMPLE: You 
specified source_dirnamewith a negative number of 
rdns. 

ACTION 

Call the function with a syntactically correct 
source_dirname. The n field in struct Dir_dn or struct 
Dir_rdn must be a positive value. If you provide an 
attrjd and attr_valuein struct Dir_ava, each field 
must have a length greater than zero and the pointer 
set to a non-N U LL val ue. 1 f you do not provide these 
fields, the length must be zero. 

MESSAGE 

FTE151_INV_SRC_FNAME 

CAUSE 

1 nvalid source_filenameparameter; syntax is incorrect. 

ACTION 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 

MESSAGE 

FTE152_INV_SRC_INIT_ID 

CAUSE 

Invalid input_dcb->source_init_id parameter for 
ft_fcopy() or ft_fmove(); syntax is incorrect. 

ACTION 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 

32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 
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FTAM return_codes 

inout_dcb->result.return_code 


FTE153_INV_STORE_ACCOUNT 

I nvalid storage_account parameter; syntax is incorrect. 

Ensure characters in the parameter are part of the 
graphic string character set. These ordinal values are 
32 to 126 and 160 to 255. If used within escape 
sequences, the values 27, 142, and 143 are also 
available. 


FTE154_INV_STRUCT_ID 

I nvalid structurejd parameter; the specified value is 
not within the Ft_structure_id enumeration. 

Call ft_sdata() with a valid structurejd. 


FTE155_NO_SYNCH_IN_GROUP 

You made a synchronous cal I within a group; you called 
a function with a synchronous return_event_name 
while grouping was open on the specified connection. 
EXAMPLE: You calledft_bgroup() on aconnection and 
then called ft_select() synchronously on that same 
connection. 

Call the function with an asynchronous 
return a/ent name 


FTE15 6_INV_FUNC_UNITS 

The bits for the FT_FU_XXX defined constants are not 
set correctly in the input_dcb->connect_inJnfo. 
fundional_units parameter for ft_conned(). 
EXAMPLE: You set Bit (14) in the parameter, but only 
Bits (5) to (13) are valid. 

Corredly set the FT_FU_XXX bits for the 
input_dcb->conned_in_info. fundional_units 
parameter and call ft_conned() again. 
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inout_dcb->result.return_code 

MESSAGE 

FTE157_NULL_BUFF_PTR 

CAUSE 

Pointer to data buffer is NULL. EXAMPLE: You called 
ft_sdata() and passed a NULL pointer in for the 
data_unit. 

ACTION 

Call ft_sdata() with a non-NULL buffer pointer. 

MESSAGE 

FTE158_INV_CONT_TYPE 

CAUSE 

Invalid contents_typecontents_info. document.name 
parameter; invalid struct Octet_stri ng. 

ACTION 

Call the function with a valid Ft_contents_type 
structure. The struct Octet_string is invalid if the 
length field is greater than zero and the pointer is 

NULL or if the length is greater than 65535. 

MESSAGE 

FTE15 9_INV_FADU_ID 

CAUSE 

1 nvalid fadu_identity.fadu_form or 
fadujdentity.fadujnfo parameter for ft_read(), 
ft_write(), ft_erase(), or ft_locate(). 

ACTION 

Call the function with fadu identity.fadu form equal 
to FT_FADU_LOCATI ON. Additionally, the 
fadujdentity.faduj nfo must beafadujocationthat is 
in the Ft_fadu_location enumeration. 

MESSAGE 

FTEl60_INV_FADU_OP 

CAUSE 

1 nvalid fadu_operation parameter for ft_write(); the 
specified value is not within the Ft_fadu_operation 
enumeration. 

ACTION 

Call ft_write() with a valid fadu_operation. 
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FTEl61_NULL_FILENAME 

You passed a null pointer to filename on a function 
that requires filename to have a non-NULL value. 

Call the function with a valid, non-NULL filename. 


TEl62_NULL_SRC_FNAME 

You called ft_fcopy() or ft_fmove() with a NULL 
source_filename. 

Call the function with a valid, non-NULL 
source filename. 


FTEl63_SAME_FILE 

Du plicate filenames when source and destination are 
identical; you called ft_fcopy() or ft_fmove(), but 
sped fiedthesame sou rce a n d dest i n at i on fi I e-stor e a n d 
the same source and destination file. 

Call the function using different source and 
destination files. 


FTEl66_UNKN_ATTR_GROUP 

The bits for the FT_AG_XXX defined constants are not 
set correctly in the input_dcb->connect_in_info. 
attribute_groups parameter for ft_connect(). 
EXAMPLE: You set Bit (1) in theattribute_groupfield, 
but only Bits (13) to (15) are valid. 

Correctly set the FT_AG_XXX bits for the 
input_dcb->connect_in_info. attribute_groups 
parameter and call ft_connect() again. 
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MESSAGE 

FTE167_UNKN_SERV_CLASS 

CAUSE 

U nknown i nput_dcb-> connect_i n_i nfaservice_cl ass 
parameter; the bits for the FT_SC_XXX defined 
constants were either invalid or not set. EXAMPLE: 

You set Bit (1) in the input_dcb-> 
connect_in_info.service_class parameter, but only Bits 
(11) to (15) are valid. 

ACTION 

Call ft_connect() with a valid FT_SC_XXX bits set for 
the input_dcb->connect_in_info. service_class 
parameter. 

MESSAGE 

FTEl69_INV_P RIVATE_USE 

CAUSE 

Invalid private_useparameter; invalid struct 

Octet_stri ng. 

ACTION 

Call the function with a valid private_use. The struct 
Octet_string is invalid if thelength field isgreater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 

MESSAGE 

FTE170_INV_FUTURE_FILE SIZE 

CAUSE 

The specified future_filesize parameter is less than 
zero. 

ACTION 

Call the function with a positive future_filesize. 

MESSAGE 

FTE171_INV_FILE_AVAILABILITY 

CAUSE 

1 nvalid file_avai labi 1 ity parameter; the specified value 
is not within the Ft_fi 1 e_avai 1 abi 1 ity enumeration. 

ACTION 

Call the function with a valid fi 1 e_a va i 1 a bi 1 i ty. 
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FTE172_INV_THRESHOLD 

The threshold parameter for ft_bgroup() exceeds the 
maximum number of calls allowed within a group. 

Call ft_bgroup() with a valid threshold value. The 
threshold cannot be zero or greater than five. 


FTE173_INV_FTQOS 

Invalid input_dcb->connect_in_info. quality_of_service 
parameter; the specified value is not within the Ft_qos 
enumeration. 

Call ft_connect() with a valid 
i nput_dcb->connect_i n_i nfo. quality_of_service 


FTE174_ATTRIB_UNMODIFIABLE 

A bit is set in the attributes mask that cannot be 
modified or set for the specified call. EXAM PLE: You 
called ft_cattributes() and specified the contents_type 
as an attribute you want to change, but contents_type 
is not modifiable 

Call the function with valid mask bits set. Ensure you 
can change the specified attribute for the given 
function. 


FTE175_FCANCEL_IND_RECEIVED 

While in the process of sendi ng (ft_sdata()) or recei ving 
data (ft_rdata()), the responder detected an error and 
sent a cancel indication totheftamjnit. 

Examine the cancel indication data and respond by 
callingft_rcancel(). 
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MESSAGE 

FTE176_INV_OVERWRITE 

CAUSE 

Invalid input_dcb-overwrite parameter for ft_fcopy() 
or ft_fmove(); the specified value is not within the 

F t_d el ete_over wr i te en u mer at i on. 

ACTION 

Call the function with a valid input_dcb-overwrite 

MESSAGE 

FTE177_INV_CLAS S 

CAUSE 

Invalid class parameter; the specified value is not 
within the Ft_class enumeration. 

ACTION 

Call the function with a valid class. 

MESSAGE 

FTEl7 8_INV_STRING_SIGN 

CAUSE 

Invalid string_significance parameter; the specified 
value is not within the Ft_string_significance 
enumeration. 

ACTION 

Call the function with a valid string_significance 

MESSAGE 

FTEl81_INV_DE_PRIM_TYPE 

CAUSE 

1 nvalid data_unit->data. data_etement->prim_type 
parameter for ft_sdata(); the data_unit->data. 
data_element->prim_typespecified in the 
Ft_data_element structure is nonexistent. The 
prim_type must be in the Ft_prim_typeenumeration. 

ACTION 

Call ft_sdata() with a valid data_unit->data. 
data_element->pri m_type 
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FTEl82_INV_DE_PRIMITIVE 

I nvalid data_unit->data.data_element->primitivefor 
ft_sdata(); octet_stringsyntax is incorrect. EXAMPLE: 
You specified FT_DE_OCTET_STRI NG as the 
data_unit->data.data_element-> pri m_type and then 
specified an invalid octet_string. 

Call ft_sdata() with a valid 
data_unit->data.data_element->primitive. The 
octet_string is invalid if the length field is greater than 
zero and the pointer is NULL or if the length is greater 
than 65535. 


FTEl83_INV_READ_PAS SWD 

I nvalid read password; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 


FTEl84_INV_INSERT_PASSWD 

I nvalid insert password; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 


FTEl85_INV_REPLACE_PASSWD 

I nvalid replace password; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length is greater than zero 
and the pointer non- NULL or if thelength isgreater 
than 65535. 
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MESSAGE FTE186_INV_EXTEND_PASSWD 

CAUSE I nvalid extend password; syntax is incorrect. 

ACTI ON Call the function with a valid Ft_single_file_pw. A 

password is invalid if the length field is greater than 
zero and the pointer is NULL or if the length is greater 
than 65535. 


MESSAGE FTE187_INV_ERASE_PASSWD 

CAUSE I nvalid erase password; syntax is incorrect. 

ACTI ON Call the function with a valid Ft_single_file_pw. A 

password is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 


MESSAGE FTE188_INV_READATTR_PASSWD 

CAUSE Invalid read_attributepassword; syntax is incorrect. 

ACTI ON Call the function with a valid Ft_single_file_pw. A 

password is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 


MESSAGE FTE18 9_INV_CHANGEATTR_PASSWD 

CAUSE I nvalid change_attributepassword; syntax is incorrect. 

ACTI ON Call the function with a valid Ft_single_file_pw. A 

password is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 
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FTEl90_INV_DELETE_PASSWD 

I nvalid delete_fiIepassword; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the pointer is NULL or if the length is greater 
than 65535. 


FTEl91_INV_FILESTORE_PASSWD 

I nvalid filestore_pw password; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the poi nter is NULL or if the length is greater 
than 65535. 


FTEl92_INV_CREATE_PASSWD 

I nvalid create_file_pw password; syntax is incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the poi nter is NULL or if thelength isgreater 
than 65535. 


FTEl93_INV_SRCFS_PASSWD 

I nvalid source_filestore_pw password; syntax is 
incorrect. 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the poi nter is NULL or if thelength isgreater 
than 65535. 
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MESSAGE 

FTE194_INV_DESTFS_PASSWD 

CAUSE 

Invalid dest_filestore_pw password; syntax is incorrect. 

ACTION 

Call the function with a valid Ft_single_file_pw. A 
password is invalid if the length field is greater than 
zero and the pointer is NULL or if the length is greater 
than 65535. 

MESSAGE 

F T E19 6_DIRNAME_NO_ADDR 

CAUSE 

The dirname parameter for ft_fdelete(), 
ft_frattributes(), or ft_fcattributes() has no associated 
presentation address. Either it is not configured for 
your network, or you incorrectly typed the name. 

ACTION 

Call the function with a configured dirname that 
identifies the desired FTAM responder. 

MESSAGE 

FTEl97_DEST_DIRNAME_NO_ADDR 

CAUSE 

The destination_dirname parameter for ft_fcopy() or 
ft_fmove() has no associated presentation address. 

Either it is not configured for your network, or you 
incorrectly typed the name. 

ACTION 

Call the function with a configured 
destination_dirnamethat identifies the desired FTAM 
responder. 

MESSAGE 

FTEl98_SRC_DIRNAME_NO_ADDR 

CAUSE 

The source_di rname parameter for ft_fcopy() or 
ft_fmove() has no associated presentation address. 

Either it is not configured for your network, or you 
incorrectly typed the name. 

ACTION 

Call the function with a configured sou rce_di rname 
that identifies the desired FTAM responder. 
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FTEl99_INV_DU_NODE_DESC 

You called ft_sdata() with an invalid 

node_descri ptor.node_name of type struct Octet_stri ng. 

Call ft_sdata() with a valid node_descriptor. The struct 
Octet_string is invalid if the length field is greater than 
zero and the pointer is NULL or if thelength isgreater 
than 65535. 


FTE2 0 0_U S R_C AN C_D AT A_T RAN 

You canceled the data transfer. This message returns 
on ft_rdata() when you call ft_cancel(), a positive 
confirmation returns, and ft_rdata() requests are 
pending. 

I nformative message; no action required. 


FTE2 0l_INV_SRC_CONCUR_CNTL 

The input_dcb->src_concur_cntl parameter is invalid 
for ft_fcopy() or ft_fmove(). 

Call the function with a valid file lock in each 
input_dcb->src_concur_cntl field. 


FTE2 02_INV_DEST_CONCUR_CNTL 

The input_dcb->dest_concur_cntl parameter is invalid 
for ft_fcopy() or ft_fmove(). 

Call the function with a valid file lock in each 
input_dcb->dest_concur_cntl field. 
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FTAM return_codes 

inout_dcb->result.return_code 

MESSAGE 

FTE50l_ABNORMAL_TERM 

CAUSE 

One of the connections on a HLCF call was terminated 
abnormally. 

ACTION 

Refer to the OS 1 Troubleshooting Guide 

MESSAGE 

FTE5 02_LOC_RES_UNAVAIL 

CAUSE 

Required resources are not obtainable for a HLCF call; 
generated when all connections for the given ftamjnit 
are exhausted; returns on HLCF calls. 

ACTION 

Refer totheOSI Troubleshooting Guide 

MESSAGE 

FTE503_REM_SYS_UNSUITABLE 

CAUSE 

A remote system negotiated below the minimal 
functional_units required to complete the request; 
returns on HLCF calls. 

ACTION 

Refer totheOSI Troubleshooting Guide 

MESSAGE 

FTE504_TRANSFER_CANCEL 

CAUSE 

The responder canceled the data transfer on a H LCF 
call. 

ACTION 

Refer totheOSI Troubleshooting Guide 

MESSAGE 

FTE505_TRANSFER_DEST_ABORT 

CAUSE 

The responder on the desti nati on node aborted the 
data transfer on a HLCF call. 

ACTION 

Refer totheOSI Troubleshooting Guide 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


FTAM return_codes 

inout_dcb->result.return_code 


FTE5 0 6_TRANSFER_ERROR 

The responder ended the data transfer on a HLCF call; 
indicates an unsuccessful end data indication arrived 
at one of the nodes. 

Refer totheOSI Troubleshooting Guide 


FTE507_TRANSFER_SRC_ABORT 

The responder on the source node aborted the data 
transfer on a HLCF call. 

Refer totheOSI Troubleshooting Guide 
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FTAM return_codes 

inout_dcb->result.return_code 
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H P vendor codes 


This chapter contains a list of H P-specific errors returned in the 
inout_dcb->result.vendor_codefield. The vendor_codes reflect 
H P-specific error information; you do not receive errors specific to other 
vendors in this field. 
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HP vendor codes 


• The mapftam.h file contains defined constants for H P vendor_codes. 

• To receive a printable character string, call ft_gperror(). 

Refer to the "H andl i ng E rrors" chapter i n the HP FTAM / 9000 
Programmer's Guide for information on checking for and handling 
errors. 
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inout 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


dcb->resuIt.vendor code 


FTVO0 0_NO_ADDL_INFO 

No additional information is available 
I nformative message; no action required. 


FTVl0l_UNABLE_TO_RCV_IPC_CON 

Unabletoestablish interprocess communication (I PC) 
connection with ftamjnit. 

Collect relevant error information and contact your HP 
support representative. 


FTVl02_CANNOT_KILL_INITIATOR 

U nable to deactivate ftamj nit. 

The ki 11 () function failed on ftamjnit. Check the log file 
for errors logged by ftamjnit. Find ftamj nit's process 
ID (PI D) and kill the ftamjnit manually. 


FTV103_INTERNAL_ERROR 

An internal error occurred. 

Check the log file for logged error messages. Collect 
relevant error information and contact your H P support 
representative. 
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HP vendor_codes 

inout_dcb->result.vendor_code 


MESSAGE FTV10 4_CANN0T_EXEC_INITIAT0R 

CAUSE Cannot executeftamjnit 

ACTION • Check the log file for errors logged by ftamj nit. 

• Consult H P-UX system reference manuals for action 
correspond! ng to errno. 

• Collect relevant error information and contact you 
HP support representative. 


MESSAGE FTV105_AE_INVOC_TABLE_FULL 

CAUSE Application Entity (AE) invocation table is full. 

ACTION Verifythat applications are shutting down invocations 

when finished. You cannot establish new AE invocation 
for presentation addressed that are not currently active. 
When AE invocations terminate, entries will become 
available. 


M E SSAGE FTV10 6_AE_LABEL_TABLE_FULL 

CAUSE The maximum number of ftamj nits for a single process 

was exceeded. 

ACTION Deactivate all ftamj nits that are no longer in use. 


MESSAGE FTV10 7_SEM_ERROR 


CAUSE Semaphore error. 


ACTION 


Check the log file. 

Consult H P-UX system reference manuals for action 
correspondi ng to errno. 

Collect relevant error information and contact your 
HP support representative. 
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MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


FTVl0 8_SHMEM_ERROR 

Shared memory error. 

• Check the log filefor errors logged by ftamjnit. 

• Consult H P-UX system reference manuals for action 
correspond! ng to errno. 

• Collect relevant error information and contact your 
HP support representative. 


FTV109_BAD_IPC_MSG 

Bad interprocess message. 

Check the log filefor logged error messages. Collect 
relevant error information and contact your H P support 
representative. 


FTVl10_VIRTUAL_MEMORY_EXHAUSTED 

Current resources are insufficient to honor request; 
virtual memory is exhausted. 

Check your memory management. Free any unused 
resources (e.g., memory), call ft_dfdcb() to free 
initialized unused debs, and call the function again. 


FTVll1_CID_TABLE_FULL 

Connectionjd table is full. 

Check the log filefor logged error messages. Free some 
connection entries by releasing or aborting connections. 


FTVl12_CONFIG_ERROR 

Configuration error. 

Check and correct the OSI Configuration database. 
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HP vendor_codes 

inout_dcb->result.vendor_code 

MESSAGE 

FTV113_NO_AE_INVOC_ENTRY 

CAUSE 

The AE invocation entry for this presentation address is 
missing. 

ACTION 

Collect relevant error information and contact your HP 
support representative. 

MESSAGE 

FTV201_EM_EMPTY_EVENT_EXP 

CAUSE 

Event management internal error. 

ACTION 

Check the log file for logged error messages. Collect 
relevant error information and contact your H P support 
representative. 

MESSAGE 

F TV2 0 2_E M_E VE N T_MAX_E X C D 

CAUSE 

Event management error; maximum number of events 
was exceeded. 

ACTION 

Free some memory resources and call the function 
again. If the error still occurs, collect relevant error 
information and contact your HP support 
representative. 

MESSAGE 

FTV203_EM_INTERNAL_ERROR 

CAUSE 

Event management internal error. 

ACTION 

Check the log file for logged error messages. Collect 
relevant error information and contact your H P support 
representative. 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


FTV30l_ILLEGAL_CALL_IN_GROUP 

You called an illegal function within a group. You 
requested an illegal call whilegrouping was open on a 
connection. 

Call only valid functions within a group. 


FTV302_CANNOT_INIT_D CB_TABLE 

Unableto initialize DCB table. 

Call the function again. If the error still occurs, collect 
relevant error information and contact your H P support 
representative. 


F TV3 0 3_CANN0 T_AD D_T 0_D CB_TABLE 

U nable to add to DCB table. 

Free some memory resources and call the function 
again. If the error still occurs, collect relevant error 
information and contact your HP support 
representative. 


FTV3 0 4_CANNOT_INIT_ICS 

The FTAM library cannot initialize the initial 
configuration store (I CS). 

Check and correct the OSI Configuration database. 


FTV3 05_CANNOT_ACCESS_ICS 

The FTAM library cannot access the ICS. 

Check and correct the OSI Configuration database. 
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HP vendor_codes 

inout_dcb->result.vendor_code 

MESSAGE 

FTV30 6_CANNOT_DECODE_DDN 

CAUSE 

The FTAM library cannot decode the directory 
distinguished name to a struct Dir_dn. 

ACTION 

Check the log file for logged error messages and 
recovery actions. If necessary, refer to the OSI 
Troubleshooting Guide 

MESSAGE 

FTV30 7_INCOMPATIBLE_STACK 

CAUSE 

Your application was linked with a version of 
libmapftam.a which is not compatible with the 
underlying OSI network software (or "stack"). 

ACTION 

Re-link the application with the version of libmapftam.a 
on the system experiencing the error. 

MESSAGE 

FTV3 0 8_STACK_NOT_INITIALIZED 

CAUSE 

The underlying OSI network software (or "stack") has 
not been started. 

ACTION 

Start the underlying OSI network software. 

MESSAGE 

FTV4 0l_ERROR_IN_GROUP_CAUSED_STATE_FAILURE 

CAUSE 

After making a grouped request, one of the requests 
within the threshold set for the group failed; therefore, 
the regime did not change. 

ACTION 

Check the action_result, state_result, and diagnostic in 
the inout_dcb to determine which request failed and 
why. If the error still occurs, collect relevant error 
information and contact your HP support 
representative. 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


FTV4 02_FUNC_UNIT_NEGOTIATED_DOWN 

The responder does not support all thefunctional_units 
requested on theft_connect() request. 

I nformative message; no action required. Check to see 
which functional_units the responder supports. Attempt 
the appropriate action using low level calls if the 
functional_units supported allow it. 


FTV4 03_ABORT_BEFORE_CON_CNF_REQ 

An abort indication returned on a connection before the 
responder confirmed the request. 

Check the inout_dcb->diagnostictodeterminethe 
reason for the abort and call the function again. 


FTV40 4_NE G_CNF_ON_CON_REQ 

The responder sent a negative confirmation on an 
ft_connect() request. 

Check Association Control Service Element (ACSE) 
errors and inout_dcb->diagnosticto determine the 
reason for the rejection and call the function again. 


FTV4 05_HLCF_ABORT_IND_RCVD 

An abort indication was received on a high level context 
free (HLCF) connection. 

Check the inout_dcb->diagnostictodeterminethe 
reason for the abort and call the function again. 
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HP vendor_codes 

inout_dcb->result.vendor_code 

MESSAGE 

FTV40 6_HLCF_SRC_ABORT_IND_RCVD 

CAUSE 

An abort indication was received on an HLCF source 
connection. 

ACTION 

Check the inout_dcb->diagnostic to determine the 
reason for the abort and call the function again. 

MESSAGE 

FTV4 07_HLCF_DEST_ABORT_IND_RCVD 

CAUSE 

An abort indication was received on an HLCF 
destination connection. 

ACTION 

Check the inout_dcb->diagnostic; then call the function 
again. 

MESSAGE 

FTV40 8_EXTRA_RDATA_REQ_AT_TRANS_END 

CAUSE 

Extra ft_rdata() request remained after a 
DATA_END_IND indication. 

ACTION 

1 nformative message; no action required. 

MESSAGE 

FTV40 9_NE G_SELECT_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the 
select request within a H LCF call. 

ACTION 

Check the inout_dcb->diagnostictodeterminethe 
reason for thefailureand call the function again. 

MESSAGE 

FTV410_NEG_CREATE_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the 
create request within a HLCF call. 

ACTION 

Check the inout_dcb->diagnostic to determine the 
reason for thefailureand call the function again. 
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MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


FTV41l_NEG_OPEN_CNF_ON_HLCF_REQ 

The responder sent a negative confirmation on the open 
request within a H LCF call. 

Check the inout_dcb->diagnostictodeterminethe 
reason for the failure and call the function again. 


FTV412_NEG_RATTR_CNF_ON_HLCF_REQ 

The responder sent a negative confirmation on the read 
attributes request within a HLCF call. 

Check the inout_dcb->diagnostictodeterminethe 
reason for the failure and call the fundi on again. 


FTV413_NEG_CATTR_CNF_ON_HLCF_REQ 

The responder sent a negative confirmation on the 
change attributes request within a FI LCF call. 

Check the inout_dcb->diagnostic to determine the 
reason for the failure and call the fundi on again. 


FTV414_NEG_EDATA_IND_ON_HLCF_REQ 

Negative data end indication on an FILCF call. 

Check the inout_dcb->diagnostictodeterminethe 
reason for the failure and call the fundi on again. 


FTV415_NE G_E TRANS_CNF_ON_HLCF_REQ 

The responder sent a negative confirmation on the 
transfer end request within a FILCF call. 

Check the inout_dcb->diagnostic to determine the 
reason for the failure and call the fundi on again. 
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HP vendor_codes 

inout_dcb->result.vendor_code 

MESSAGE 

FTV416_NEG_CLOSE_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the close 
request within a HLCF call. 

ACTION 

Check the inout_dcb->diagnostic to determine the 
reason for thefailureand call the function again. 

MESSAGE 

FTV417_NEG_DELETE_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the 
delete request within a H LCF call. 

ACTION 

Check the inout_dcb->diagnostictodeterminethe 
reason for thefailureand call the function again. 

MESSAGE 

FTV418_NEG_DE SE LE CT_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the 
deselect request within a FI LCF call. 

ACTION 

Check the inout_dcb->diagnostic to determine the 
reason for thefailureand call the function again. 

MESSAGE 

FTV419_NEG_RELEASE_CNF_ON_HLCF_REQ 

CAUSE 

The responder sent a negative confirmation on the 
release request within a H LCF call. 

ACTION 

Check the inout_dcb->diagnostic to determine the 
reason for thefailureand call the fundi on again. 

MESSAGE 

FTV42 0_HLCF_STATE_ERROR 

CAUSE 

H LCF state error. 

ACTION 

Check the log file. Colled relevant error information; 
then contad your FH P support representative. 
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MESSAGE 

CAUSE 

ACTION 


HP vendor_codes 

inout_dcb->result.vendor_code 


FTV42l_NOT_IN_DATA_TRANS_PHASE 

You called ft_rdata() while in a regime other than data 
transfer. 

Call ft_rdata() in the Data Transfer regime only after 
an ft_read() request and before the transferring of data 
ends. 
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inout_dcb->result.vendor_code 
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Diagnostic errorjds 


This chapter contains a list of diagnostic values returned in 
theinout_dcb->diagnostic->error_id field. These errors are generated in 
theFTAM protocol machine (F PM) and the Virtual Filestore (VFS), not 
in the interface. This chapter includes only those diagnostic->error_ids 
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Diagnostic errorjds 


returned by H P initiators and responders; it may or may not include 
diagnostics returned by other vendors. The causes and recovery actions 
listed are specific to HP's implementation. 

• The f_error.h file contains defined constants for all FTAM 
di agnostic->error_ids. 

• Toreceivea printable character string, review the information in 
i nout_dcb->di agnostic->further_detai Is. 

Refer to the "H andl i ng E rrors" chapter i n the HP FTAM / 9000 
Programmer's Guide for information on checking for and handling 
errors. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 


inout dcb->diagnostic->error id 


3 MESSAGE F_F T AM_MG T_P ROB L EM 

CAUSE FTAM management problem. 

ACTION Collect relevant error information and contact your 
HP support representative. 


8 MESSAGE F_SUBSEQ_ERR 

CAUSE This diagnostic returns on grouped functions if the 

threshold is not met. If the threshold number of 
functions is not processed before a state_result 
failure is detected, a negative re-sponse is made for 
the group. All grouped functions after the 
ft_bgroup() response and before the state_result 
failure will have an action_result of failure and will 
havea diagnostic->error_id of F_SUBSEQ_ERR. 

ACTION Check inout_dcb-xJi agnostic to determine which 

function caused the group to fail. Refer to the 
appropriate section in this manual for specific 
recovery action guidelines. 


10 MESSAGE F_ACCESS_VIOLATES_VFS_SEC 

CAUSE The access control element for this file or directory 

is violated. 

ACTI ON Check the access control and correct it. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 

11 MESSAGE F_ACCESS_VIOLATES_LOCAL_SEC 

CAUSE Could not access the local real file or directory due 

to UNIX permission problem. 

ACTI ON Check the permissions of the file and directory. 


1007 MESSAGE F_F T AM_P ROT 0_E RR 

CAUSE FTAM protocol error; may be one of the foil owing 

reasons. 

• The parameter values could not be encoded. 

• You issued the calls in an incorrect order. 

ACTION Use the appropriate corrective action, as follows. 

• Call the function with valid parameters. 

• Call the functions in the correct order. 


1009 MESSAGE F_FTAM_PROTO_ERR_FUNCU 

CAUSE FTAM protocol error. You issued a request using a 

functional_unit that was not negotiated between 
ftamjnit and the responder on an ft_connect() 
request. 

ACTION Call ft_connect() using all required 

functional_units, which are based on the 
service_classes specified. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 

1011 MESSAGE F_LWR_LAYER_FAIL 

CAUSE A layer below FTAM (e.g., Presentation or Session 

layer) caused or reported an error. Usually this 
error is indicated by an abort indication; FTAM 
returns abort information on this diagnostic after 
calling ft_ireceive(). 

ACTION E xecute the netfmt utility to obtain log information 
and correct the error as described in the log 
message. If needed, collect relevant error 
information and contact your HP support 
representative. 


1015 MESSAGE F_ILLEGAL_GRP_SEQ 

CAUSE The grouping sequence is illegal. Depending on the 

service_class negotiated, only certain sequences of 
PDUs can be in a grouped request. 

ACTION Call the grouped functions in a valid sequence. 

Refer to the HP FTAM/ 9000 Programmer's Guide 
for acceptable sequences when grouping functions. 


2008 MESSAGE F_ASSOC_MGT 

CAUSE Association management; returns when an internal 

data structure is not present or incorrect. 

ACTION Ensuretheft_aeactivation() data structures are 

present and correctly set. You have two options. 

• Terminate the call. 

• Reactivate the ftamj nit and try to re-establish 
the connection. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 

2015 MESSAGE F_INIT_ID_UNACCEPT 

CAUSE The login name (initiator identity) is unacceptable 

on an ft_connect() request. Either the name does 
not exist or your incorrectly entered it. 

ACTI ON Call the function with a valid initiator identity (i.e., 
an existing HP-UX login name). 


2020 MESSAGE F_INVALID_FS_PASSWD 

CAUSE Thefilestore_pw is invalid. 

ACTI ON Call the function with a valid filestore_pw. The 

filestore_pw is the H P-UX password associated with 
the initiator identity that is the H P-UX login. 


3000 MESSAGE F_F IL E_N O T_F OUND 

CAUSE The filename specified on ft_select() does not exist 

or you entered it incorrectly. 

ACTI ON Call ft_select() with a correct and existing filename. 


3002 MESSAGE F_INIT_ATTRIB_NOT_POSSIBLECAUSE 

CAUSE The initial attributes do not allow the request to be 

completed. You did not supply the filename, 
contents_type, or permitted_actions on a request. 

ACTION Call the function with a filename, contents_type, or 
permitted_actions as needed. 
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Diagnostic errands 

inout_dcb->diagnostic->error_id 

3004 MESSAGE F_NON_EXISTENT_FILE 

CAUSE The shadow file for the filename specified on 

ft_select() does not exist. 

ACTION Remove the existing FTAM data file and recreate it 
using FTAM functions; doing so recreates the 
shadow file. 


3005 MESSAGE F_FILE_ALREADY_EXISTS 

CAUSE You called ft_create() with file_status set to 

FT_NE W, and a file by that same name already 
exists in the filestore. 

ACTION Call ft_create() with a different filename. 


3007 MESSAGE F_CANNOT_DELETE_FILE 

CAUSE On an ft_select(), ft_create(), or ft_fopen() function, 

you selected a file without setting the 
FT_FA_DELETE_FI LE bit in the requested_access 
field. 

ACTION Set FT_FA_DELETE_FI LE to ON (1) and call the 
function again. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 


3010 MESSAGE F_CONC_CTL_NOT_POSSIBLE 

CAUSE You cannot currently access the file for one of the 

following reasons 

• Another application is accessing the file and 
enum Ft_file_lock in Ft_concurrency_control is 
set such that you cannot concurrently access the 
file. 

• The requested_access and concurrency_control 
parameters are not compatible. 


EXAMPLES: The requested_accessfor an action is 
not set and you request a concurrency_control other 
than FT_NOT_REQUIRED or FT_NO_ACCESS. 
Someone has the file selected with the 
FT_FA_I NSERT action set to FT_EXCLUSI VE and 
you request an FT_FA_I NSERT action of 
FT_SH ARED. 

ACTI ON Call the function again after the file is closed by the 
other application. If you still cannot access the file, 
ensure your concurrency_control parameter is 
consistent with your requested_access para-meter. 
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Diagnostic errands 

inout_dcb->diagnostic->error_id 

3016 MESSAGE F_ACCESS_CTL_INCONSISTENT 

CAUSE This diagnostic returns on ft_select(), ft_create(), 

and HLCF calls. The cause may be one of the 
following reasons. 

• The bits set in the FT_AC_XXX defined 
constants prohibit your requested access to the 
file. 

• The requested_access, conc_access, or 
file_passwords values do not match the access 
control element corresponding to your initiator 
identity. 

EXAM PLE: Passwords for ft_select() do not match 
those in the Ft_access_control_element 
corresponding to the current initiator identity. 

ACTI ON Change the file attributes so that the access control 

element corresponding to your initiator identity 
allows you to perform the necessary actions 
(requested_access, conc_access, file_passwords). 


3020 MESSAGE F_CREATE_SLCTD_EXIST_FILE 

CAUSE On an ft_create() call, the file already exists and the 

file_status is set to FT_OLD. 

ACTI ON I nformative message; no action required. 


3023 MESSAGE F_CRE AT E_OVRRD_N 0 T_P 0 S SIB L E 

CAUSE A file exists without a corresponding shadow file, 

and thefile_status is set to FT_NEW, FT_OLD, or 
FT_REPLACE_CONTENTS. 

ACTI ON Either remove the data file and try again or set 
fi I e_status to F T_R E C R E AT E. 
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inout_dcb->diagnostic->error_id 

3028 MESSAGE F_REQ_ACC_VIOL_PERM_ACT 

CAU SE The bits set for the requested_access FT_FA_XXX 

defined constants are not a subset of the bits set for 
the permitted_actions FT_PA_XXX defined 
constants. 

ACTION Correctly set the FT_FA_XXX bits or call the 
function with a valid requested_access. The 
requested_access must be a subset of the 
permitted_actions values on ft_select() or ft_create(). 


4001 MESSAGE F_AT T RI B_C ANN 0 T_RE AD 

CAUSE You cannot read the file attributes because when 

you selected the file, you did not set 
requested_access to i ncl ude 
FT_FA_READ_ATTRI BUTE. 

ACTI ON Deselect the file and select it again with the 
requested_access set to include 
FT FA READ ATTRIBUTE. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 


4002 MESSAGE F_AT T RI B_C ANN 0 T_C HNG 

CAU SE You cannot change the attri bute for one of the 

following reasons. 

• When you selected the file, you did not set 
request ed_access to i ncl ude 
FT_FA_CHANGE_ATTRI BUTE. 

• You tried to add a duplicate access control 
element for an existing initiator identity. 

• You tried to change a file's name to the name of a 
file that already exists. 

ACTION Use the appropriate corrective action, as follows. 

• Deselect the file and select it again with 
requested_access set to i ncl ude 
FT_FA_CHANGE_ATTRIBUTE. 

• Remove the access control el ement for the 
existing initiator identity and insert one for the 
initiator identity you want. 

• Change the name of the file to one that does not 
exist. 


5002 MESSAGE F_BAD_FADU_TYPE_ERR 

CAUSE Thestructurejd describing the type of FADU 

information is not correct. 

ACTION Set thestructurejd to a valid value. Use 

FT JDATA_U NIT for al I document types and 
FT_NODE_DESC for FTAM-2 document types only. 
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inout_dcb->diagnostic->error_id 

5014 MESSAGE F_DATA_ELEMENT_TYPE 

CAUSE The prim_typefield in struct Ft_data_element is not 

set correctly. 

ACTI ON Set prim_typeto a valid value. For FTAM-1 

document types, prim_type must be I A5_STRI NG 
or GENERAL_STRI NG. For FTAM-2 document 
types, prim_typemust beGRAPFIIC_STRING. For 
FTAM-3 document types, pri m_type must be 
OCTET_STRI NG. For INTAP-1 document types, 
pri m_type must beRECORD_END or 
RECORD_CONT. 


5017 MESSAGE F_OPR_INCONSISTENT 

CAUSE The operation is inconsistent. Causes may include 

the foil owing cases. 

• You called ft_read() though the processing_mode 
on ft_open() did not have the FT_PM_READ bit 
set to ON (1). 

• You called ft_write() though the 
processing_mode on ft_open() did not have 
FT_PM_I NSERT, FT_PM_REPLACE, or 
FT_PM_EXTEND bit set ON (1), depending on 
the document type. 

ACTION Correctly set the FT_PM_XXX bits on the 
processi ng_mode before cal I i ng ft_open(). 
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Diagnostic errands 

inout_dcb->diagnostic->error_id 

5023 MESSAGE F_PROC_MD_INCONSISTENT 

CAU SE The bits set for the processi ng_mode FT_FA_XXX 

defined constants are not a subset of the bits set for 
the requested_access FT_PA_XXX defined 
constants. 

ACTI ON Correctly set the FT_FA_XXX bits or call ft_open() 
with a valid processing_mode The processing_mode 
must be a subset of the requested_access values on 
ft_sel ect() or ft_create(). 


5024 MESSAGE F_ACCESS_CNTXT_NOT_AVAIL 

CAUSE Theaccess_context is not available. Given a 

particular document type, a VFS implementation 
may not support certain access_contexts. 
EXAMPLE: You tried accessing an FTAM-2 file 
with an access_context of FI A (FI ierarchical All). 

ACTI ON Use an access_context value that is consistent with 
the file document type. 


502 6 MESSAGE F_B AD_WR IT E 

CAUSE On an ft_write() function, the Ft_fadu_location in 

Ft_fadu_identity points to a non-existent FADU; 
therefore, you cannot write to the file (FTAM-1, 
FTAM-3, and INTAP-1) or FADU (FTAM-2). 

ACTION Call ft_sdata() with a valid fadujdentity. For 

FTAM-1, FTAM-3, and INTAP-1 document types, 
fadujdentity must be FT_FI RST. For FTAM-2 
document types, fadujdentity must be FT_BEGI N. 
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Diagnostic errorjds 

inout_dcb->diagnostic->error_id 

5027 MESSAGE F_B AD_RE AD 

CAUSE Thefadujdentity on an ft_read() request points to 

a non-existent FADU; therefore, you cannot read 
the file (FTAM-1, FTAM-3, and INTAP-1) or FADU 
(FTAM-2). 

ACTI ON Call ft_read() with a valid fadujdentity. For 

FTAM-1, FTAM-3, and I NTAP-1 document types, 
fadujdentity must be FT_FI RST. For FTAM-2 
document types, fadujdentity must be FT_BEGI N. 


5031 MESSAGE F_LCL_FAIL_DVC_FAIL 

CAUSE Local device failure. An I/O error occurred when 

trying to write the file via an HP-UX system call. 
For example, you may be out of disc space. 

ACTION If needed, create disc space on the real filesystem 
(responder) where the write failure occurred. 
Otherwise, collect relevant error information and 
contact your HP support representative. 
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Event Management Errors 


This chapter contains a list of values that may be returned when calling 
em_wait(), em_fdmemory(), and em_gperror(). These errors return in the 
result->return_codeand result->vendor_codefields. To receive a printable 
character string for returned errors, call em_gperror(). 
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Event Management Errors 


Refer to the "H andl i ng E rrors" chapter i n the HP FTAM / 9000 
Programmer's Guide for information on checking for and handling 
errors. 
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Event Management Errors 

EM return codes 


EM return codes 

This section contains a list of values that may be returned in the 
result->return_codefield when calling em_wait(), em_fdmemory(), and 
em_gperror(). 

The error EME031J NVALI D_BUF_PTR returns only as a function 
return value if the result parameter issettoa NULL pointer (i.e., it does 
not return in the return_codeor vendor_code). 


MESSAGE success 

CAUSE Successful function execution (noerror). 

ACTI ON I nformative message; no action required. 


MESSAGE EME002_EXP_EMPTY 

CAUSE No events were posted; therefore, there is no reason to 

wait. 

ACTION Call a function asynchronously before calling 

em_wait(). 


MESSAGE EME004_TIME_INV 

CAUSE The timeout parameter is invalid. 

ACTI ON Call em_wait() with a valid timeout parameter. Valid 
timeout values are as follows. Parameter timeout 
Period-1- I ndefinite wait 0 - Return immediately 
with results 1 to 32767 - Wait up tothis time period 
(tenths of seconds) 
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Event Management Errors 

EM return codes 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


EME005_TIMEOUT 

None of the posted events were noted within the time 
allotted by the timeout parameter. 

Call em_wait() again to receive the noted events, 
possibly with a longer timeout parameter. 


EME 0 31_INVALID_BUF_PTR 

Invalid buffer pointer; you provided a NULL pointer 
instead of a valid address for one of the parameters. 
The resuIt->vendor_code indicates the 
return_event_nameis invalid. Only thefunction return 
value reflects the error if the result parameter is 
invalid. 

Set the return_event_nameand result parameters to 
valid, non- NULL values. 


EME 0 3 2_IPC_ERROR 

Your program could not access the ftamj nit 
processi ng the return_event_name. 

Refer to the result->vendor_codefor the actual I PC 
error value. Call em_gperror() to translate the value 
into a message and refer to the log file to determine 
why you could not access ftamj nit. If you are unable 
to correct the error, refer to the OS I Troubleshooting 
Guide 


EMEO 90_INV_DYNAMIC_MEM_PTR 

The memory_poi nter you specified is not the address of 
dynamic memory allocated by the interface. 

Only call em_fdmemory() with the address of dynamic 
memory allocated by em_gperror(). 
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Event Management Errors 

EM return codes 


MESSAGE 

CAUSE 

ACTION 

MESSAGE 

CAUSE 

ACTION 


EMEO 97_NO_SPACE_AVAILABLE 

The interface could not allocate sufficient space for the 
return_string and vendor_string; the system ran out of 
memory. 

Free any allocated dynamic memory that is no longer 
needed and call the function again. EXAMPLE: You 
made multi pi e cal Is to em_gperror() requesti ng that 
the interface allocate memory; however, you did not 
cal I em_fdmemory() to free the memory after 
em_gperror() completed. 


EME 0 9 8_INVALID_RETURN_CODE 

The i nput_results structure contai ns a return_code 
that does not exist. 

Only call em_gperror() with an 
input_result->return_codethat was returned by the 
i nterface. 
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EM vendorcodes 

E M vendor codes 

This section contains a list of values that may be returned in the result- 
>vendor_codefield when calling em_wait(), em_fdmemory(), and 
em_gperror(). 

result->return_code 

MESSAGE EMVOOO_NO_CODE_SUPPLIED 

CAUSE Noadditional vendor-specific information is available; 

the return_code provides sufficient information. 

ACTI ON I nformative message; no action required. 

M E SSAGE EMVO 02_PARAM_EVENT_NAME 

CAUSE The return_event_namebuffer pointer is set to NULL. 

ACTION Set the return_a/ent_name parameter to a valid, 

non-NULL value. 

MESSAGE E MV 0 0 3_P ARAM_ I N_RE S U L T 

CAUSE Theinput_result buffer pointer issettoNULL. 

ACTION Set the input_result parameter toa valid, non-NULL 
value. 

MESSAGE EMV004_PARAM_RET_STRING 

CAUSE The return_string buffer pointer is set to NULL. 

ACTI ON Set the return_string parameter toa valid, non-NULL 

value. 
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Event Management Errors 

EM vendor codes 


MESSAGE 

CAUSE 

ACTION 


EMV005_PARAM_VEN_STRING 

The vendor_string buffer pointer is set to NULL. 

Setthevendor_string parameter to a valid, non-NULL 
value. 
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Event Management Errors 

EM vendorcodes 
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HP FTAM/9000PICS 


For a copy of the Protocol I mplementation Conformance Statement 
(PI CS) for the H P FTAM/9000 product, please contact your FI P support 
representative. 
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Installation Filesets 


The files listed in this chapter are installed in the indicated directories at 
the time you install FTAM. Installing the reference page (man page) files 
is recommended, but omitting them will not operationally affect FTAM. 
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Files Created During Software Installation 


Files Created During Software 
Installation 


Files in fileset FTAM 

Function 

/opt/ftam/bin/ftam 

1 interactive interface executable 

/opt/ftam/bin/fcattr 

fcattr command 

/opt/ftam/bin/fcp 

fcp command 

/opt/ftam/bin/fdel 

fdel command 

/opt/ftam/bin/fIs 

fls command 

/opt/ftam/bin/fmv 

fmv command 

/opt/ftam/bin/fchdoc 

Utility to change FTAM attributes of a 
local file 

/opt/ftam/sbin/osiinitshm 

OTS startup utility for FTAM 

/opt/ftam/sbin/osirmshm 

OTS startup utility for FTAM 

/opt/ftam/sbin/osistat 

OTS startup utility for FTAM 

/opt/ftam/sbin/id.conf 

OTS startup utility for FTAM 

/opt/ftam/lbin/ftam_resp 

FTAM responder daemon process 

/opt/ftam/lbin/ftam_init 

FTAM initiator service provider process 

/opt/ftam/include/map.h 

1 nclude file for common MAP library 

/opt/ftam/include/mapftam.h 

Programmatic i nterface structure 
definitions 

/opt/ftam/include/f_error.h 

Programmatic interface error definitions 

/opt/ftam/lib/libmap.a 

MAP library for FTAM 

/opt/ftam/lib/llib-lmap 

lint library for FTAM programmatic 
interface 
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Installation Filesets 

Files Created During Software Installation 


Files in fileset FTAM 

Function 

/opt/ftam/lib/llib-lmap.In 

lint library for FTAM programmatic 
interface 

/opt/ftam/lib/libmapftam.a 

Programmatic interface library definitions 

/opt/ftam/lib/llib-lmapftam 

lint library for FTAM programmatic 
interface 

/opt/ftam/lib/llib-lmapftam.In 

lint library for FTAM programmatic 
interface 

/opt/ftam/lib/nls/C/acse.cat 

Network tracing and logging NLS catalog 

/opt/ftam/lib/nls/C/cm.cat 

Network tracing and logging NLS catalog 

/opt/ftam/lib/nls/C/fchdoc.cat 

Message catalog used by fchdoc command 

/opt/ftam/lib/nls/C/fmt12 4 f.cat 

Network tracing and logging NLS catalog 

/opt/ftam/lib/nls/C/ftam_cmds.cat 

Message catalog used by FTAM user 
i nterface commands 

/opt/ftam/lib/nls/C/ftamfmt.cat 

Network tracing and logging NLS catalog 

/opt/ftam/lib/nls/C/hps.cat 

Network tracing and logging NLS catalog 

/opt/ftam/lib/nls/C/mapftam.cat 

Message catalog used by ft_gperror() and 
FTAM user interface commands 

/opt/ftam/lib/nls/C/mapem.cat 

N LS catalog for em_gperror() 

/opt/ftam/lib/nls/C/osistat.cat 

NLS catalog for osistat 

/opt/ftam/lib/nls/C/shm.cat 

N LS catalog for shared memory manager 

/opt/ftam/shlib/libmap.si 

MAP shared library 

/opt/ftam/shlib/libmapftam.si 

FTAM shared library 

/opt/ftam/shlib/libfmtftam.si 

Network tracing and logging subformatter 

/opt/ftam/shlib/libfmt116f.si 

Network tracing and logging subformatter 

/opt/ftam/shlib/libfmt119f . si 

Network tracing and logging subformatter 

/opt/ftam/shlib/libfmt121f.si 

Network tracing and logging subformatter 


Chapter 6 


93 













Installation Filesets 

Files Created During Software Installation 


Files in fileset FTAM 

Function 

/opt/ftam/shlib/libfmt122 f.si 

Network tracing and logging subformatter 

/opt/ftam/shlib/libfmt12 4 f.si 

Network tracing and logging subformatter 

/opt/ftam/shlib/fmtl24f.si 

Network tracing and logging subformatter 

/opt/ftam/demos/Makefile 

Makefile for FTAM demo 

/opt/ftam/demos/README 

README file for FTAM demo 

/opt/ftam/demos/setup 

Set up of sample file 

/opt/ftam/demos/ftm_globs.h 

1 nclude file for demo programs 

/opt/ftam/demos/ftm_conn.c 

Demo for connection establishment 

/opt/ftam/demos/ftm_dirnam.c 

Source file for demo programs 

/opt/ftam/demos/ftm_hlcopy.c 

Demofilecopy using high-level functions 

/opt/ftam/demos/ftm_llcopy.c 

Demofilecopy using low-level functions 

/opt/ftam/demos/ftm_parm.c 

Source file for demo programs 

/opt/ftam/demos/ftm_util.c 

Source file for demo programs 

/opt/ftam/demos/resp_api/Makefile 

Source file for demo programs 

/opt/ftam/demos/resp_api/test_resp 

Source file for demo programs 

/opt/ftam/demos/resp_api/test_respl 

Source file for demo programs 

/opt/ftam/demos/resp_api/test_vsp 

Source file for demo programs 

/opt/ftam/demos/resp_api/ftm_util.c 

Source file for demo programs 

/opt/ftam/demos/resp_api/vsp.c 

Source file for demo programs 

/etc/opt/ftam/conf/ftam_conf 

Miscellaneous FTAM configuration 
parameters 

/etc/opt/ftam/conf/ftam_pw 

Configuration file for FTAM password 
types 
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Installation Filesets 

Files Created During Software Installation 


Files in fileset OSIF-MAN 

Function 

/opt/ftam/man/manl.Z/fcattr.l 

Man page for indicated function 

/opt/ftam/man/manl.Z/fchdoc . 1 

Man page for indicated function 

/opt/ftam/man/manl.Z/fcp.1 

Man page for indicated function 

/opt/ftam/man/manl.Z/fdel. 1 

Man page for indicated function 

/opt/ftam/man/manl.Z/fIs . 1 

Man page for indicated function 

/opt/ftam/man/manl.Z/ftam.1 

Man page for indicated function 

/opt/ftam/man/manl.Z/ftam_resp.1 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_abort.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_aeactiva.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_aedeacti.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_aereset.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_bgroup.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_cancel.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_cattribu.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_close.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_connect.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_create.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_delete.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_deselect.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_dfdcb.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_didcb.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_edata.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_egroup.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_erase.3n 

Man page for indicated function 
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Files Created During Software Installation 


Files in fileset OSIF-MAN 

Function 

/opt/ftam/man/man3.Z/ft_etransfe.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fcattrib.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fclose.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fcopy.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fcopy_aet.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fdelete.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fdelete_aet.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fdmemory.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fmove.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fmove_aet.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_fopen.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_frattrib.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_gperror.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_ireceive.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_locate.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_nwcleare.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_open.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_rattribu.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_rcancel.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_rdata.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_rdataqos.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_read.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_rrequest.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z/ft_sdata.3n 

Man page for indicated function 
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Files Created During Software Installation 


Files in fileset OSIF-MAN 

Function 

/ opt/ftam/man/man3. Z/ ft_select.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z / ft_write.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z/em_hp_select.3n 

Man page for indicated function 

/opt/ftam/man/man3.Z / em_wait.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z / em_gperror.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z/em_fdmemory.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z / em_hp_sigio.3n 

Man page for indicated function 

/ opt/ftam/man/man3.Z / ftam.3n 

Man page for overview of 
programmatic FTAM 

/ opt/ftam/man/man4.Z/ftamrc.4 

Man page for FTAM startup file 
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Files Created During Software Installation 
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HP FTAM/9000 Reference Pages 


The following are the HP FTAM/9000 reference pages (man pages) 
available online. If you have loaded the reference pagefilesets, you can 
view them online by using the man(l) command at the H P-UX prompt. 
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HP FTAM/9000 Reference Pages 


Entry Name 

Description 

em_fdmemory(3) 

free dynamic memory allocated by Event Management 

em_gperror(3) 

translate an Event Management error toastring 

em_hp_select(3) 

wait for MAP 3.0 and non-MAP events 

e m_hp_sigio(3) 

enable/disable signal notification for MAP 3.0 

em_wait(3) 

wait for an asynchronous MAP 3.0 event 

fcattr(l) 

change the attributes of an FTAM file 

fcp(l) 

copy an FTAM file 

fdel(l) 

remove an FTAM file 

fls(l) 

list an FTAM file or directory 

ft_abort(3) 

abort an FTAM connection 

ft_aeactivation(3) 

activate an FTAM initiator 

ft_aedeactivation(3) 

deactivate an FTAM initiator 

ft_aereset(3) 

reset an FTAM initiator 

ft_bgroup(3) 

begin a group of FTAM functions 

ft_cancel(3) 

cancel FTAM data transfer in progress 

ft_cattributes(3) 

change the file attributes of an FTAM file 

ft_close(3) 

close an FTAM file 

ft_connect(3) 

establish a connection with an FTAM responder 

ft_create(3) 

create an FTAM file 

ft_delete(3) 

delete the currently selected FTAM file 

ft_deselect(3) 

deselect the currently selected FTAM file 

ft_dfdcb(3) 

free a dynamically initialized FTAM data control block 

ft_didcb(3) 

initialize an FTAM data control block 
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Entry Name 

Description 

ft_edata(3) 

end a series of FTAM data primitives 

ft_egroup(3) 

end a group of FTAM functions 

ft_erase(3) 

erase all or part of an FTAM file 

ft_etransfer(3) 

end an FTAM data transfer 

ft_fcattributes(3) 

change the file attributes of an FTAM file 

ft_fcattri butes_aet(3) 

change the file attributes of an FTAM file 

ft_fclose(3) 

close and either deselect or delete an FTAM file 

ft_fcopy(3) 

copy an FTAM file 

ft_fcopy_aet(3) 

copy an FTAM file 

ft_fdelete(3) 

delete an FTAM file 

ft_fdelete_aet(3) 

delete an FTAM file 

ft_fdmemory(3) 

free dynamic memory allocated by FTAM 

ft_fmove(3) 

move an FTAM file 

ft_fmove_aet(3) 

move an FTAM file 

ft_fopen(3) 

select or create and then open an FTAM file 

ft_frattributes(3) 

read the file attributes of an FTAM file 

fMrattri butes_aet(3) 

read the file attributes of an FTAM file 

ft_gperror(3) 

translate an FTAM error to a printable string 

ftj receive(3) 

receive an FTAM abort indication 

ftj ocate(3) 

locate a specific part of an FTAM file 

ft_nwcleared(3) 

note when outstanding FTAM resource is cleared 

ft_open(3) 

open an FTAM file 

ft_rattributes(3) 

read the file attributes of an FTAM field. 

ft_rcancel(3) 

respond to an FTAM cancel indication 
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Entry Name 

Description 

ft_rdata(3) 

receive a block of FTAM data 

ft_read(3) 

request transfer of data from FTAM 

ft_rrequest(3) 

release an FTAM connection 

ft_sdata(3) 

send a block of FTAM data 

ft_select(3) 

select an FTAM file 

ft_write(3) 

request transfer of data to an FTAM file 

ftam(l) 

OSI file transfer, access and management program 

ftamrc(3) 

FTAM security file. 
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